From 73e7b0838c77e37b133b5b2b8df3be2b5ea38254 Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Wed, 6 Oct 2004 04:28:42 +0000 Subject: [PATCH] Clarify documentation for selection modes. (#154188, Jonathan Blandford, 2004-10-06 Matthias Clasen * gtk/tmpl/gtkenums.sgml: Clarify documentation for selection modes. (#154188, Jonathan Blandford, new wording proposed by Owen Taylor) --- docs/reference/ChangeLog | 6 ++++++ docs/reference/gtk/tmpl/gtkenums.sgml | 12 +++++++----- 2 files changed, 13 insertions(+), 5 deletions(-) diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog index b39969dd7a..78517ee8c0 100644 --- a/docs/reference/ChangeLog +++ b/docs/reference/ChangeLog @@ -1,3 +1,9 @@ +2004-10-06 Matthias Clasen + + * gtk/tmpl/gtkenums.sgml: Clarify documentation for selection + modes. (#154188, Jonathan Blandford, new wording proposed by + Owen Taylor) + 2004-10-05 Matthias Clasen * gtk/gtk-sections.txt: Add gtk_accelerator_get_label(). diff --git a/docs/reference/gtk/tmpl/gtkenums.sgml b/docs/reference/gtk/tmpl/gtkenums.sgml index 1a58ba7b7c..7378500052 100644 --- a/docs/reference/gtk/tmpl/gtkenums.sgml +++ b/docs/reference/gtk/tmpl/gtkenums.sgml @@ -332,20 +332,22 @@ Indicated the relief to be drawn around a #GtkButton. - +Used to control what selections users are allowed to make. @GTK_SELECTION_NONE: No selection is possible. @GTK_SELECTION_SINGLE: Zero or one element may be selected. -@GTK_SELECTION_BROWSE: Exactly one element is always selected - (this can be false after you have changed the selection mode). +@GTK_SELECTION_BROWSE: Exactly one element is selected. In some circumstances, + such as initially or during a search operation, it's possible for no element + to be selected with %GTK_SELECTION_BROWSE. What is really enforced is that + the user can't deselect a currently selected element except by selecting + another element. @GTK_SELECTION_MULTIPLE: Any number of elements may be selected. Clicks toggle the state of an item. Any number of elements may be selected. Click-drag selects a range of elements; the Ctrl key may be used to enlarge the selection, and Shift key to select between the focus and the child pointed to. -@GTK_SELECTION_EXTENDED: Deprecated, behaves identical to - %GTK_SELECTION_MULTIPLE. +@GTK_SELECTION_EXTENDED: Deprecated, behaves identical to %GTK_SELECTION_MULTIPLE. -- 2.30.2